/**
 * webpack.config.js  webpack的配置文件
 *    作用: 指示 webpack 干哪些活 (当你运行webpack指令时, 会加载里面的配置)
 *
 *    所有构建工具都是基于nodejs平台运行. 模块化默认采用commonjs
 *
 *    font:
 *
 */
const path = require('path')
// HtmlWebpackPlugin 是一个构造函数
const HtmlWebpackPlugin = require('html-webpack-plugin');
const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin

module.exports = {
  // webpack配置
  // 入口起点
  entry: './src/index.js',
  // 输出
  output: {
    // 输出文件名
    filename: "built.js",
    // 输出路径
    // __dirname nodejs的变量, 代表当前文件的目录绝对路径
    // 当前文件的目录: webpack.config.js 是当前文件, 所在目录 03.compile_package_....
    path: path.resolve(__dirname, 'build')
  },
  // loader的配置
  module: {
    rules: [
      // 详细loader的配置
      {
        test: /\.css$/,
        use: ['style-loader', 'css-loader']
      },
      // 打包其他资源(除了html/js/css资源以外的资源)
      {
        // 排除css/js/html资源
        exclude: /\.(css|js|html|less|jpg|png|gif|json)$/,
        loader: 'file-loader',
        options: {
          name: '[hash:8].[ext]'
        }
      }
    ]
  },
  // plugins的配置
  plugins: [
    // 详细plugins的配置
    // html-webpack-plugin
    // 功能: 默认会创建一个空的HTML, 自动引入打包输出的所有资源(JS/CSS)
    // 需求: 需要有结构的HTML文件  --> 构造器传入参数 HtmlWebpackPlugin(option)
    new HtmlWebpackPlugin({
      // 复制 ./src/index.html 文件, 并自动引入打包输出的所有资源(JS/CSS)
      template: "./src/index.html"
    }),
    new BundleAnalyzerPlugin({
      //  可以是`server`，`static`或`disabled`。
      //  在`server`模式下，分析器将启动HTTP服务器来显示软件包报告。
      //  在“静态”模式下，会生成带有报告的单个HTML文件。
      //  在`disabled`模式下，你可以使用这个插件来将`generateStatsFile`设置为`true`来生成Webpack Stats JSON文件。
      analyzerMode: 'server',
      //  将在“服务器”模式下使用的主机启动HTTP服务器。
      analyzerHost: '127.0.0.1',
      //  将在“服务器”模式下使用的端口启动HTTP服务器。
      analyzerPort: 9999,
      //  路径捆绑，将在`static`模式下生成的报告文件。
      //  相对于捆绑输出目录。
      reportFilename: 'report.html',
      //  模块大小默认显示在报告中。
      //  应该是`stat`，`parsed`或者`gzip`中的一个。
      //  有关更多信息，请参见“定义”一节。
      defaultSizes: 'parsed',
      //  在默认浏览器中自动打开报告
      openAnalyzer: true,
      //  如果为true，则Webpack Stats JSON文件将在bundle输出目录中生成
      generateStatsFile: false,
      //  如果`generateStatsFile`为`true`，将会生成Webpack Stats JSON文件的名字。
      //  相对于捆绑输出目录。
      statsFilename: 'stats.json',
      //  stats.toJson（）方法的选项。
      //  例如，您可以使用`source：false`选项排除统计文件中模块的来源。
      //  在这里查看更多选项：https：  //github.com/webpack/webpack/blob/webpack-1/lib/Stats.js#L21
      statsOptions: null,
      // 日志级别。可以是'信息'，'警告'，'错误'或'沉默'。
      logLevel: 'info'
    })
  ],
  // 模式
  mode: 'development',
  // mode: 'production',

  // 开发服务器 devServer: 用来自动化 (自动编译, 自动打开浏览器, 自动刷新浏览器)
  // 特点: 只会在内存中编译打包, 不会有任何输出
  // 启动devServer指令为: npx webpack-dev-server
  devServer: {
    // 项目构建后路径
    contentBase: path.resolve(__dirname, 'build'),
    // 开启gzip压缩
    compress: true,
    // 端口
    port: 3000,
    // 自动打开浏览器
    // open: true
  }
}
